home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / cnet / cnettoolkit2a.lha / FPButton.README! < prev    next >
Text File  |  1994-12-16  |  4KB  |  109 lines
  1. ============================================================================
  2.             FPButton (Flux Point VDE Buttons) README! by PMK
  3. ============================================================================
  4.  
  5.     The following text was originally written by Pete. I cleaned it up a bit,
  6. but other than that it appears exactly as Pete sent it to me. There is also
  7. a file titled "FPButton" included in this archive that shows you an example
  8. on using Pete's technique for creating a VDE-type config editor. Please feel
  9. free to chop it up for use in your own files and/or creations or else use the
  10. tehniques Pete discusses below to embellish your own programs, but we would
  11. ask that you PLEASE SHARE WHATEVER YOU COME UP WITH! :-) Happy Holidays!
  12.  
  13.               How to create your own buttons using FPButton.
  14.              ------------------------------------------------
  15.  
  16.     Each button is defined by a series of variables, containing the type,
  17. position, etc. The first variable set is the position (x & y coords.),
  18. defined like this:
  19.  
  20.         XC.<#>=<X coord.>
  21.         YC.<#>=<Y coord.>
  22.  
  23.     The <#> is the number of this button. This number is used for the next
  24. set of variables, which are the movement variables:
  25.  
  26.         ML.<#>=<M#>         (Move LEFT variable)
  27.         MR.<#>=<M#>         (Move RIGHT variable)
  28.         MU.<#>=<M#>         (Move UP variable)
  29.         MD.<#>=<M#>         (Move DOWN variable)
  30.  
  31.     Again, <#> is the number of this button. <M#> is the button the cursor
  32. should move to, when the appropriate direction is selected. If the cursor
  33. isn't allowed to move in a direction, then set the <M#> to 0.
  34.  
  35.     The next variable is the button itself, and is defined like this:
  36.  
  37.         but.<#>="\c7\z4Text for Button\z0\c7 "
  38.  
  39.     The button variable should always contain 12 MCI chars, (like 4 sets of
  40. color changes etc.), as this number is used to get the correct position
  41. later on in the program. (Can be changed if you also change the '12' in the
  42. main routines)
  43.  
  44.     The next variable is the Type of button you want:
  45.  
  46.         bty.<#>=<type>
  47.  
  48.     Four types of buttons exists:
  49.  
  50.         "0" is an ACTION BUTTON.
  51.  
  52.             When an ACTION BUTTON is pressed, the program calls a subroutine,
  53.         called 'BUTTON<#>' where <#> is the number of the button. It is up
  54.         to you to define this routine in the program! REMEMBER to end it
  55.         with a RETURN command. Here's an example of an action button:
  56.  
  57.             BUTTON51:;exi=1;return
  58.  
  59.  
  60.         "1" is a TOGGLE BUTTON.
  61.  
  62.             A TOGGLE BUTTON toggles between Yes and No (1 and 0).
  63.  
  64.  
  65.         "2" is a STRING BUTTON.
  66.  
  67.             A STRING BUTTON has an additional button variable to control the
  68.         length and MCI input options. This variable looks like this:
  69.  
  70.             le.<#>="<MCI opt> <length>"
  71.  
  72.             Where <#> is the button number.
  73.  
  74.             <MCI opt> is any legal MCI input option PLUS THE NUMBER 4!!!
  75.                 So if you want the input to be numeric only (MCI opt. 64),
  76.                 then this value would be 64+4=68!!
  77.  
  78.             <length> is the maximum length of the input requester.
  79.  
  80.  
  81.         "3" is a CYCLE BUTTON.
  82.  
  83.             A CYCLE BUTTON is very similar to the TOGGLE BUTTON, but requires
  84.         two additional button variables, defined like this:
  85.  
  86.              mc.<#>=<cycles>
  87.             cnm.<#>="<var name>"
  88.  
  89.             Where <#> is the button number.
  90.  
  91.             <cycles> is the number of cycle options.
  92.  
  93.             <var name> is the NAME OF THE VARIABLE, that holds the cycle
  94.                 options.
  95.  
  96.             These variables should be defined in the start of the program,
  97.         like this:
  98.  
  99.             cyc.0='Arexx  ';cyc.1='CNet C ';cyc.2='DOS    ';cyc.3='Paragon'
  100.  
  101.             Then the two button variables would look like this:
  102.  
  103.              mc.<#>=4          (4 different options (0-3))
  104.             cnm.<#>='cyc'      (the name of the button definitions is 'cyc')
  105.  
  106. ============================================================================
  107.                 $VER: FPButton 1.01 (27.03.94) by PMK
  108. ============================================================================
  109.